home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / misc / picboot2.lha / PicBoot.Man < prev    next >
Text File  |  1993-02-21  |  11KB  |  302 lines
  1.  
  2.  
  3.     PicBoot 1.02                User manual                 PicBoot 1.02
  4.  
  5.  
  6.     NAME 
  7.         PicBoot 
  8.  
  9.     SYNOPSIS 
  10.         PicBoot FILES/M/A,L=LIST/S,B=BLACK/S,D=DETACH/S,DEF=DEFAULT/S 
  11.  
  12.     DESCRIPTION 
  13.         Have  you  removed  all output in your 2.0 startup, and only see
  14.         an  empty  screen  during  bootup? Wouldn't it be nice to have a
  15.         picture  instead?  A picture that disappeared when the Workbench
  16.         screen was opened? 
  17.  
  18.         If  so,  PicBoot is certainly a program for you. What it will do
  19.         is  to  read  any  IFF file containing an ILBM picture, and show
  20.         that  picture.  As  soon as the Workbench screen appears (or you
  21.         press any mouse-button), the picture will go away.  
  22.  
  23.         PicBoot  features  a fast BODY-unpacker (use the BLACK option to
  24.         get  the  best  speed),  optional  auto-detaching,  and a way to
  25.         automatically  random select among any number of different files
  26.         to show.  
  27.  
  28.         To  activate  PicBoot, add a line your startup-sequence, looking
  29.         something like this: 
  30.  
  31.         PicBoot Pics:Hi-res/RockyCalvin.Pic BLACK DETACH 
  32.  
  33.         Or, if you have a list of files in "Work:Text/PicList": 
  34.  
  35.         PicBoot Work:Text/PicList LIST BLACK DETACH 
  36.  
  37.         This  line  should be located very early in the Startup-Sequence
  38.         (no  point  in  placing  it near the LoadWB commant, is it?? :),
  39.         but  keep  it  after SetPatch. PicBoot will only output any text
  40.         if  it  fails,  so don't re-direct its output. Note however that
  41.         if  you  place  PicBoot  *before*  any  additional  monitors are
  42.         installed,  you'll be stuck with the default.monitor for showing
  43.         your  picture. The DEFAULT switch may be of help here (see below
  44.         for more information about this switch).  
  45.  
  46.         Make  sure  no program makes any output in the CLI window, since
  47.         then  the  Workbench  screen  will open with a boring CLI-window
  48.         instead...  
  49.  
  50.         Apart   from  OS  2.04,  PicBoot  doesn't  require  any  special
  51.         libraries.    The    only    non-ROM    library    required   is
  52.         iffparse.library.  
  53.  
  54.     OPTIONS 
  55.  
  56.         FILES 
  57.             This  is  the  only  required argument. Here you specify the
  58.  
  59.  
  60.     Page 1                                           (Printed 21 Feb 93)
  61.  
  62.  
  63.     PicBoot 1.02                User manual                 PicBoot 1.02
  64.  
  65.  
  66.             name  of the picture you want to view. You may enter several
  67.             files  here,  in  which case PicBoot will select one of them
  68.             randomly,  and  show that one. It may also be the name of an
  69.             ASCII  file  containing a filename list if you specified the
  70.             LIST option (see below).  
  71.  
  72.             NOTE:  The random-number generator used is quite simple, and
  73.             is  based  on the current system time. I don't know if it is
  74.             a  "good"  random  generator.  If  you have an algorithm you
  75.             think is better, don't be afraid to send it to me.  
  76.  
  77.         L=LIST 
  78.             If   this   switch  is  present,  it  instructs  PicBoot  to
  79.             interpret  the  *first*  filename  specified  in  the  FILES
  80.             argument  as  the  name  of  a  file  containing  a  list of
  81.             pictures  (any  ohter filename(s) in the FILES argument will
  82.             be  ignored).  PicBoot  will then randomly select one of the
  83.             filenames in the file, and view that picture.  
  84.  
  85.             This  filelist  file  is  an ASCII (text) file with a simple
  86.             layout.  On  the  first  line  you  specify  the  number  of
  87.             filenames  in  the file. This is usually <number of lines in
  88.             file>-2  (one  line  is occupied by the count, and the other
  89.             is  the  last  linefeed). The rest of the file is simply the
  90.             files  to  view,  one  filename  per  line. So, a short file
  91.             could look like this: 
  92.  
  93.             3
  94.             Work:Pics/Comics/Calvin01.Pic
  95.             Work:Pics/Comics/Calvin02.Pic
  96.             Work:Pics/Comics/Calvin03.Pic
  97.  
  98.         B=BLACK 
  99.             This  will make PicBoot open up a black screen (very small 1
  100.             bitplane,  almost  a  0 bitplane screen.. :) before the real
  101.             screen  is  opened  (and this one will open behind the black
  102.             one).  Since  the black screen needs very little DMA time to
  103.             be  displayed,  the  CPU  will  get  much more access to the
  104.             CHIP-mem  rather  than  if  a  4  bitplane hires screen (ECS
  105.             system)  would  be  in  the  front.  This  can speed up BODY
  106.             unpacking  rather much (since during boot there is no screen
  107.             to hide behind... :).  
  108.  
  109.         D=DETACH 
  110.             This  will cause PicBoot to detach from its calling CLI when
  111.             the  picture  is  fully  loaded  etc.  If  you  specify this
  112.             option,  you  shouldn't RUN PicBoot. This option will reduce
  113.             memory  fragmentation, and will ensure that the picture gets
  114.             loaded  quickly.   However,  the  implementation maybe isn't
  115.             the  most  "system-friendly" one (but there aren't that many
  116.             alternatives...),  hence  the  switch. I don't think it will
  117.             be any problems, but one can never know... :) 
  118.  
  119.  
  120.     Page 2                                           (Printed 21 Feb 93)
  121.  
  122.  
  123.     PicBoot 1.02                User manual                 PicBoot 1.02
  124.  
  125.  
  126.  
  127.         NC=NOCENTER 
  128.             This option will disable the centering of the picture.  
  129.  
  130.         DEF=DEFAULT 
  131.             If  this  switch  is present, PicBoot will force the picture
  132.             to  use the default.monitor, regardless of what was actually
  133.             stored  in  the  picture (in the CAMG chunk). This is needed
  134.             since  very  early  in  the  startup, default.monitor is the
  135.             only  monitor available (e.g. vga.monitor is not available).
  136.             In  the  future,  I  might add more types of "forcing" (e.g.
  137.             force  a  picture  to  PAL,  NTSC  or whatever that might be
  138.             useful).  
  139.  
  140.     KNOWN BUGS AND LIMITATIONS 
  141.         I  do  not  know  of  any real bugs in PicBoot. However, certain
  142.         parts  of  the  program  may still contain bugs. E.g.,  pictures
  143.         that  have a mask bitplane (mskHasMask) are supported, but since
  144.         I  only  have  one  (compressed) picture that have a mask, there
  145.         might  be  a  bug  in that code (can't test it properly). Please
  146.         report any problems! 
  147.  
  148.         Currently  there  is  no  support  for  SHAM,  PCHG  and similar
  149.         "special"  pictures.  I'm  not sure if this could be implemented
  150.         in  a  "clean"  way  (that  would  work on future systems etc.).
  151.         Color  cycling  is  currently  ignored  (I have no need for it..
  152.         :).  
  153.  
  154.         PicBoot  should  work  on  most Amigas. It has been tested on an
  155.         Amiga  500  with  2.04,  and an Amiga 4000 (with 3.0), and works
  156.         fine on these computers.  
  157.  
  158.     AUTHOR 
  159.         PicBoot  was  written  in  100% assembler by Magnus Holmgren. If
  160.         you  have any comments etc, feel free to send me a note. You can
  161.         reach me via internet on any of these addresses: 
  162.  
  163.             cmh@augs.se
  164.             magnus_holmgren@augs.se
  165.             cmh@lysator.liu.se
  166.             d91magho@und.ida.liu.se
  167.  
  168.         Fido-net    messages    should    go   to   "Magnus   Holmgren",
  169.         2:204/404.6@fidonet.org.  Snail  mail  should  reach  me  if you
  170.         write the following address on the envelope: 
  171.  
  172.             Magnus Holmgren
  173.             Rydsvägen 254  A:14
  174.             S-582 51  Linköping
  175.             SWEDEN
  176.  
  177.         Since  I  start  doing  my military service in a not too distant
  178.  
  179.  
  180.     Page 3                                           (Printed 21 Feb 93)
  181.  
  182.  
  183.     PicBoot 1.02                User manual                 PicBoot 1.02
  184.  
  185.  
  186.         future  (end  of March), it may take a little while before I can
  187.         reply to your message, so please have some patience! :) 
  188.  
  189.     DISTRIBUTION 
  190.         PicBoot  is  released  as  FREEWARE. This means that you may use
  191.         and   copy  this  program  freely,  as  long  as  the  following
  192.         restrictions are followed: 
  193.  
  194.         1)  All  files  are copied in an unmodified state. If additional
  195.         information  is  needed, place it in a separate file. Preferably
  196.         redistribute in the original archive form (*.Lha).  
  197.  
  198.         2)  The copying is done on a non-commercial and non-profit basis
  199.         only.  A  copy  fee  to  cover  media costs, postage etc. may be
  200.         charged,  and  mustn't  exceed the fee to obtain an AmigaLibDisk
  201.         from Fred Fish.  
  202.  
  203.         3)  The  copier/spreader is not claiming the Copyright © of this
  204.         program.  
  205.  
  206.         Any   exceptions   from   these  restrictions  requires  written
  207.         permission from the author, Magnus Holmgren.  
  208.  
  209.  
  210.     HISTORY 
  211.         Version: 1.00  Release date: 08 Feb 93 
  212.             Initial release.  
  213.  
  214.         Version: 1.01  Release date: 14 Feb 93 
  215.             PicBoot   would   sometimes   read   past  the  end  of  the
  216.             picture-list  file, although the file was correct. Also, the
  217.             last  picture would never be showed. Fixed (thanks to Daniel
  218.             Joseph Oak for reporting).  
  219.  
  220.             Did  some  tweeking,  to make the program smaller. The total
  221.             gain  was  eaten  up  by  improved  error  messages  though.
  222.             PicBoot  will  now  more  accurately  report why the display
  223.             didn't open.  
  224.  
  225.             Added  support  for  masked ILBMs, since I discovered that I
  226.             had  such  a  picture  anyway.   :)  Since  I  only have one
  227.             picture,  its  hard to tell if it really works, but it seems
  228.             to be ok at least.  
  229.  
  230.             The  autoscrolling  of the screen didn't work. Fixed (so now
  231.             you  can view pictures larger than the screen, by moving the
  232.             invisible mouse-pointer).  
  233.  
  234.             Added the NOCENTER switch.  
  235.  
  236.         Version: 1.02  Release date: 21 Feb 93 
  237.             Added  the  DEFAULT  switch.  As Bradley Yen pointed out for
  238.  
  239.  
  240.     Page 4                                           (Printed 21 Feb 93)
  241.  
  242.  
  243.     PicBoot 1.02                User manual                 PicBoot 1.02
  244.  
  245.  
  246.             me,  there  is  only  one  "monitor"  available early in the
  247.             startup,    and    that   is   default.monitor   (and   what
  248.             default.monitor  is  can  vary. It can e.g. be PAL or NTSC).
  249.             This  switch  will make the picture use the default.monitor,
  250.             regardless what it was saved in.  
  251.  
  252.             Autoscrolling  of  screen  disabled  again, since this would
  253.             make  some  overscanned  pictures  "clipped",  even  if this
  254.             wasn't needed.  
  255.  
  256.             A bug in the init code fixed.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.     Page 5                                           (Printed 21 Feb 93)
  301.  
  302.